home *** CD-ROM | disk | FTP | other *** search
/ Saar AMOK 2 / Saar AMOK II - Oktober 1994 (1994)(Kreativ Marketing)(DE)[!][I-7598].iso / disks / amok / amok_099 / oberonprefs / oberonprefs.dok < prev    next >
Text File  |  1993-10-20  |  39KB  |  924 lines
  1.  
  2.              ------------------------------------------------
  3.              OberonPrefs 2.0 (8.10.93) © F.Schwarz - Giftware
  4.              ------------------------------------------------
  5.  
  6.                   Voreinsteller-Programm für Amiga-Oberon
  7.  
  8.                          © 1993 & geschrieben von
  9.                                Franz Schwarz
  10.                     Mühlenstraße 2, D-78591 Durchhausen,
  11.                               BR Deutschland
  12.                     Uucp: Franz_Schwarz@mil.ka.sub.org
  13.                     Fido: 2:2476/506.18 & 2:241/7506.18
  14.  
  15.                GUI erstellt mit Hilfe von GadToolsBox 37.176
  16.  
  17.            OberonPrefs ist Giftware; d.h. Sie werden ermuntert,
  18.            dem Autor ein kleines Geschenk, Geld, eine Postkarte,
  19.             o.ä. zu schicken, falls Sie das Programm verwenden.
  20.  
  21.  
  22.  
  23.                               Aus dem Inhalt
  24.                               --------------
  25.  
  26.                 Überblick über das Konzept von OberonPrefs
  27.  
  28.                      Inhalt des autorisierten Archivs
  29.  
  30.                            Installationshinweise
  31.  
  32.               Die interaktive grafische Benutzerschnittstelle
  33.                  -Gadgets
  34.                  -Menüs
  35.                  -Piktogramm-Ziehen ins Fenster
  36.  
  37.                   Kommandozeilen- und ToolTypes-Argumente
  38.                      -Die Argument-Schablone
  39.                      -Die Argumente im einzelnen
  40.                      -Benutzerdefinierbare interaktive 
  41.                         Argument-Abfrage beim WB-Start
  42.  
  43.                        Programmende & Rückgabewerte
  44.   
  45.                      Allgemeine Hinweise zum Programm
  46.   
  47.                  Vermeiden des Veränderns des Quelltextes 
  48.                  d.h. Anlegen/Ändern der OPREFS-Kopfzeile
  49.    
  50.                          Entwicklungsgeschichte  
  51.   
  52.                              Schlußbemerkungen
  53.   
  54.                             Adresse des Autors
  55.   
  56.                            Credits, Danksagungen
  57.   
  58.                         Die CygnusEd-ARexx-Skripte
  59.  
  60.  
  61.  
  62.                 Überblick über das Konzept von OberonPrefs
  63.                 ------------------------------------------
  64.  
  65.  
  66. OberonPrefs ist die Ergänzung zum Amiga-Oberon-System, auf die Sie bestimmt
  67. schon lange gewartet haben:  Ein äußerst flexibles, universelles,
  68. intuitives Voreinsteller-Programm (Preferences-Editor), das neben einer
  69. komfortablen grafischen Benutzeroberfläche auch eine durchdachte
  70. Shell-Schnittstelle (die im übrigen im vollen Umfang auch über
  71. Workbench-ToolTypes erreicht werden kann) und die Anpassung an
  72. verschiedene Landessprachen in Verbindung mit Commodore's locale.library ab
  73. Workbench 2.1 aufwärts bietet.
  74.  
  75.  
  76. Exkurs: Wie das Amiga-Oberon-System die Optionen einließt:
  77.     
  78.   Da im Handbuch nur unvollständig wiedergegeben wird, wie Amiga-Oberon/
  79.   -OLink/ -OMake die aktuellen Compiler-/ Linker-Optionen bestimmen, hier
  80.   die genaue Vorgehensweise:
  81.   
  82.   Zuerst werden die Programm-internen vorgegegebenen ('default') Optionen
  83.   herangezogen.  
  84.   
  85.   Diese Optionen werden durch eventuell in der Kommandozeile
  86.   spezifizierten Optionen -respektive durch die Workbench-ToolTypes des
  87.   aufgerufenen Werkzeugs (Oberon, OLink, OMake)- überschrieben.
  88.   
  89.   Danach ersetzen Optionen aus den möglicherweise vorhandenen
  90.   Voreinstellungsdateien Oberon.prefs und und OLink.prefs im Verzeichnis des
  91.   zu bearbeitenden Projektes die bisherigen Optionen.
  92.   
  93.   Schließlich, falls die jeweilige Voreinstellungsdatei Oberon.prefs bzw.
  94.   OLink.prefs im Verzeichnis des zu bearbeitenden Projekts nicht gefunden
  95.   wurde, diese Voreinstellungsdatei jedoch im globalen Verzeichnis OBERON:
  96.   zu finden ist, treten die Optionen aus dieser Datei an Stelle der
  97.   bisherigen Optionen.
  98.  
  99.  
  100.  
  101. Um nun auf die unterschiedlichen Vorlieben und Konfigurationen der Anwender
  102. des Amiga-Oberon-Systems eingehen zu können, besitzt OberonPrefs die
  103. Möglichkeit, die Art, wie es die Optionen einließt und schreibt,
  104. weitestgehend dem Benutzer zu überlassen.  Diese Einstellungen können
  105. selbstverständlich über Kommandozeilen-/ ToolTypes-Parameter angegeben
  106. werden, als auch als globale Einstellungen gespeichert und im interaktiven
  107. Modus geändert werden.
  108.  
  109.  
  110. OberonPrefs kennt grundsätzlich zwei verschiedene Betriebsmodi:  einen
  111. globalen Modus, in dem die globalen Voreinstellungen verändert werden, und
  112. einen Projekt-Modus, in dem die Voreinstellungen der verschiedenen Projekte
  113. und / oder einzelnen Oberon-Quelltext-Module verändert werden.
  114. Selbstverständlich besteht dabei die Möglichkeit des gegenseitigen Imports
  115. bzw. Exports der Voreinstellungen zwischen diesen Modi.
  116.  
  117.  
  118. OberonPrefs bietet die Möglichkeit, alle gegenwärtig (Amiga-Oberon 3.00)
  119. bekannten Compiler- und Linker-Optionen zu manipulieren - im Projektmodus
  120. auch diejenigen, die nur im Oberon-Quelltext-Modul angegeben werden können,
  121. aber gewöhnlich für ein ganzes Modul gelten (CodeChip, VarsChip, DataChip,
  122. Implementation).
  123.  
  124.  
  125. Da die Benutzerschnittstellen (Interaktive grafische Schnittstelle,
  126. Kommandozeilen-Schnittstelle und Workbench-ToolTypes-Schnittstelle) von
  127. OberonPrefs so gestaltet wurden, daß sie den Richtlinien aus dem 'Amiga
  128. User Interface Style Guide' für Voreinsteller-Programme weitestmöglich
  129. entsprechen, sollte die Bedienung für den mit Amiga-Voreinsteller-
  130. Programmen (z.B.  denjenigen, die zum Lieferumfang des Betriebssystems
  131. im Verzeichnis System:Prefs gehören) vertrauten Benutzer ziemlich intuitiv
  132. sein.  Unbekannt an der interaktiven grafischen Benutzerschnittstelle
  133. dürften jedoch das Konzept der zwei Operations-Modi (Global / Projekt) und
  134. die vielfältigen Einstellungsmöglichkeiten im Einstellungen-Menü sein.  Die
  135. Kommandozeilen-/ ToolTypes-Schnittstelle wurde so erweitert, daß eine
  136. möglichst vielfältige und flexible Verwendung von OberonPrefs in
  137. Stapelverarbeitungsdateien und ARexx-Skripten möglich ist.
  138.  
  139.  
  140.  
  141.                      Inhalt des autorisierten Archivs:
  142.                      ---------------------------------
  143.  
  144.      s (dir)
  145.        RexxCommands                     RexxCommands.info
  146.      txt (dir)
  147.        GetFile.mod                      GetFile.mod.info
  148.        OberonPrefs.cd                   OberonPrefs.cd.info
  149.        OberonPrefs.mod                  OberonPrefs.mod.info
  150.        OberonPrefsStrings.mod           OberonPrefsStrings.mod.info
  151.        OberonPrefs_d.ct                 OberonPrefs_d.ct.info
  152.      sym (dir)
  153.      obj (dir)
  154.        bases.o                          boopsi.o
  155.      Catalogs (dir)
  156.           deutsch (dir)
  157.             blackmagic.catalog               oberonprefs.catalog
  158.      Rexx (dir)
  159.        OCmd.ced                         OCmd.ced.info
  160.        OErr.ced                         OErr.ced.info
  161.        OOptions.ced                     OOptions.ced.info
  162.   Catalogs.info                    InstallOberonPrefs
  163.   InstallOberonPrefs.info          Oberon.Prefs
  164.   OberonPrefs                      OberonPrefs.doc
  165.   OberonPrefs.doc.info             OberonPrefs.dok
  166.   OberonPrefs.dok.info             OberonPrefs.info
  167.   obj.info                         OLink.Prefs
  168.   Rexx.info                        s.info
  169.   sym.info                         txt.info
  170.  
  171.  
  172.  
  173.                            Installationshinweise:
  174.                            ----------------------
  175.  
  176. Die Installation übernimmt das Installationsskript.  Es kopiert OberonPrefs
  177. und die Dokumentation ins OBERON:-Verzeichnis, und speichert die Kataloge
  178. aus dem catalogs-Verzeichnis ins LOCALE:-Verzeichnis, falls sie Workbench
  179. 2.1 oder höher installiert haben. Das Installationsskript installiert auf
  180. Wunsch auch die CygnusEd-ARexx-Skripte, mit denen Sie Amiga-Oberon
  181. komfortabel von CygnusEd aus steuern können.
  182.  
  183. Falls Sie OberonPrefs häufig verwenden, sollten Sie in ihre S:User-Startup-
  184. Datei den Befehl 'resident Oberon:OberonPrefs' einbauen.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.              Die interaktive grafische Benutzerschnittstelle:
  191.              ------------------------------------------------
  192.  
  193.   -------
  194.   Gadgets
  195.   -------
  196.  
  197. Außer den Gadgets, mit denen die verschiedenen Compiler-/ Linker-Optionen
  198. eingestellt werden, und die hier nicht weiter beschrieben werden, da die
  199. Bedeutungen der einzelnen Optionen im Handbuch erschöpfend erklärt sind,
  200. sind normalerweise folgende Gadgets vorhanden:
  201.  
  202. Modus-Gadget - mit ihm wird der Operationsmodus eingestellt:
  203.   Global : die globalen Compiler-/ Linker-Optionen werden verändert.
  204.   Projekt: Projekt-/ Oberon-Quelltext-Modul-spezifische Optionen werden
  205.     verändert.
  206.   *1* 
  207.  
  208. Projekt-Anzeige-Gadget - Im Projekt-Modus wird hier der Name des gerade
  209.   manipulierten Oberon-Quelltext-Moduls angezeigt. Falls der Gadget-Name
  210.   ein unterstrichenes Zeichen enthält, wirkt ein Druck auf die entsprechende
  211.   Taste wie die  Aktivierung des Datei-Gadgets.
  212.  
  213. Datei-Gadget - falls es aktiviert wird, erscheint ein
  214.   Datai-Auswahl-Eingabefeld (Filerequester), in dem ein neues Projekt 
  215.   ausgewählt werden kann. Wenn die Eingabe bestätigt wird, versucht
  216.   OberonPrefs, das Projekt zu öffnen. Wird die selektierte Datei als
  217.   Oberon-Quelltext-Modul erkannt, dann springt OberonPrefs in den Projekt-
  218.   Modus und liest die zum Projekt gehörigen Optionen gemäß den
  219.   Einstellungen im Einstellungen-Menü ein.
  220.   *1*
  221.  
  222. Speichern-Gadget - Falls im Projekt-Modus kein Dateiname angegeben
  223.   ist, erscheint zuerst ein Datei-Auswahl-Eingabefeld (Filerequester), 
  224.   in dem das Projekt, für das die Optionen zu speichern
  225.   sind, eingegeben werden soll.  Existiert die Datei nicht oder
  226.   ist sie kein Oberon-Quelltext-Modul, so wird der Vorgang abgebrochen.
  227.   Andernfalls / anschließend werden die eingestellten Optionen nach Maßgabe
  228.   der Einstellungen im Einstellungen-Menü abgespeichert, _ohne_ OberonPrefs
  229.   zu verlassen (Konzeptions-Entscheidung, wegen der zwei Operationsmodi und
  230.   der Möglichkeit, verschiedene Projekt-Einstellungen zu manipulieren!). 
  231.   Falls eines der Kommandozeilen-/ ToolTypes-Argumente OBERONOUT, OLINKOUT
  232.   oder OMAKEOUT angegeben wird, wird OberonPrefs dagegen nach dem
  233.   Abspeichern verlassen, da dann keine Umstellung des Operationsmodus /
  234.   des bearbeiteten Projektes möglich ist.
  235.   *2*
  236.  
  237. Abbrachen-Gadget - verläßt OberonPrefs ohne mögliche Änderungen
  238.   abzuspeichern.
  239.   *1*
  240.  
  241. Benutzen-Gadget - Beendet OberonPrefs, ohne die gewählten Optionen zu
  242.   speichern, gibt die gewählten Optionen aber entsprechend des
  243.   vorhandenen #?OUT-Argumentes aus.
  244.   *3*
  245.  
  246. Schließ-Gadget - Funktion entspricht derjenigen des Abbrechen-Gadgets.
  247.   Tastaturäquivalent: ESC-Taste
  248.  
  249. ZoomGadget - verkleinert ('iconify') das Fenster von OberonPrefs resp.
  250.   setzt es zurück auf seine ursprüngliche Größe.
  251.   Tastaturäquivalent: 'Z'-Taste
  252.  
  253.  
  254. Alle Gadgets, deren Titel ein unterstrichenes Zeichen aufweisen, können
  255. auch durch einen Druck auf die entsprechende Taste betätigt werden.
  256.  
  257.  
  258.  
  259. *1* :  Ist nicht vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  260.        oder OMAKEOUT beim Programmstart übergeben wird.
  261.  
  262. *2* :  Ist nicht vorhanden, falls eine der Optionen OBERONOUT, OLINKOUT oder
  263.        OMAKEOUT in Verbindung mit NOSAVEGAD beim Programmstart übergeben 
  264.        werden.
  265.  
  266. *3* :  Ist nur vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  267.        oder OMAKEOUT beim Programmstart übergeben wird.
  268.  
  269.  
  270.   -----
  271.   Menüs
  272.   -----
  273.  
  274. Projekt-Menü:
  275.   
  276.   Neu - Setzt die Optionen auf die programminternen ('Default') Werte
  277.     von Amiga-Oberon zurück und löscht den Projektnamen, falls der
  278.     Projekt-Modus aktiv ist. 
  279.     *1*
  280.  
  281.   Öffnen... - Die Funktion entspricht derjenigen des Datei-Gadgets. 
  282.     *1*
  283.   
  284.   Speichern Als... - Öffnet ein Datei-Auswahl-Eingabefeld (Filerequester),
  285.    speichert, wenn der Name eines existierenden Oberon-Quelltext-Moduls
  286.     eingegeben wurde, die eingestellten Optionen als Projekt-Optionen
  287.     dieses Projektes und springt in den Projekt-Modus falls der globale
  288.     Modus aktiv ist.
  289.     *1*
  290.  
  291.   Global Speichern - Speichert die eingestellten Optionen als globale
  292.     Voreinstellungen und springt in den globalen Modus, falls der
  293.     Projekt-Modus aktiv ist.
  294.     *1*
  295.     
  296.   Information... - Öffnet ein Informations-Fenster mit Angaben über  
  297.     OberonPrefs. 
  298.       In der letzten Zeile wird dabei der Code für die gegenwärtigen
  299.       Programm-Einstellungen im Einstellungen-Menü angezeigt, der
  300.       nach ENVARC:OberonPrefs.prefs als Ganzzahl-String geschrieben
  301.       bzw. als SETTINGS/N/K-Argument beim Programmstart übergeben
  302.       werden kann, um die gegenwärtigen Programm-Einstellungen wieder
  303.       zu erhalten.
  304.       *1*
  305.  
  306.   Beenden - Die Funktion entspricht derjenigen des Abbrechen-Gadgets.
  307.   
  308. Vorgaben-Menü:  
  309.  
  310.   Auf Vorgaben Zurücksetzen - setzt die Optionen auf die programminternen
  311.     ('Default') Werte von Amiga-Oberon zurück.
  312.     
  313.   Auf Zuletzt Global Gespeichertes - setzt die Optionen auf die zuletzt
  314.     gespeicherten globalen Voreinstellungen (bzw. auf die programminternen
  315.     'Default'-Voreinstellungen des Amiga-Oberon-Systems, falls keine
  316.     globalen Voreinstellungen existieren).
  317.     
  318.   Voreinstellungen Von Projekt... - öffnet ein Datei-Auswahl-Eingabefeld,  
  319.     und, liest, falls der Name eines existierenden Oberon-Quelltext-Moduls
  320.     eingegeben wurde, die Voreinstellungen aus diesem Projekt ohne
  321.     den Modus und / oder den Projektnamen zu ändern.
  322.     
  323.   Neu Einlesen - liest die Optionen neu ein (='Restore'-Funktion)
  324.   
  325. Einstellungen-Menü:
  326.  
  327.   Piktogramme Erzeugen? - falls aktiv erzeugt OberonPrefs Piktogramme     
  328.     für Projekte, die keine Piktogramme besitzen. Die Piktogramm-Daten
  329.     werden dabei aus OBERON:Icons/txt.info zu lesen versucht, Falls das
  330.     nicht klappt, werden die Daten des Default-System-Projekt-Piktogramms
  331.     verwendet.
  332.     *1*
  333.  
  334.   Vorgaben-Optionen Speichern?  - falls aktiv werden beim Speichern der
  335.     Voreinstellungen auch diejenigen Optionen abgespeichert, die den
  336.     programminternen ('Default') Voreinstellungen von Amiga-Oberon
  337.     entsprechen.
  338.     *1*
  339.  
  340.   Projekt-Einstellungen Lesen-Untermenü:
  341.     Die Einstellungsmöglichkeiten dieses Untermenüs beeinflussen, wie    
  342.     OberonPrefs beim Einlesen der Voreinstellungen von Projekten vorgeht.
  343.     Zunächst kann der Benutzer zwischen vier verschiedenen Arten wählen:        
  344.  
  345.       Modul & Prefs - falls aktiv liest OberonPrefs die Voreinstellungen
  346.         zuerst aus einer möglicherweise von OberonPrefs angelegten Kopf-
  347.         zeile am Anfang des Oberon-Quelltext-Moduls. Dabei werden
  348.         vorhandene, mit den Schlüsselworten OberonOpts / OLinkOpts versehene
  349.         Buchstaben-Optionen (entsprechen den Kommandozeilen-Optionen nach
  350.         '-') gelesen. Danach versucht OberonPrefs, Oberon.prefs-/
  351.         OLink.prefs-Voreinstellungsdateien heranzuziehen. Schließlich werden
  352.         auch von OberonPrefs geschriebene Quelltextoptionen ($Option(+|-))
  353.         aus einer vorhandenen OberonPrefs-Kopfzeile aus dem
  354.         Oberon-Quelltext-Modul berücksichtigt.
  355.         
  356.       Modul (Ohne Buchst.-Optionen) & Prefs - entspricht aktivem
  357.         'Modul & Prefs' mit der Ausnahme, daß die hinter den Schlüsselworten
  358.         OberonOpts / OLinkOpts folgenden Buchstaben-Optionen beim Einlesen
  359.         ignoriert werden. Dies ist die programminterne ('Default')
  360.         Einstellung von OberonPrefs, da sie der normalen Vorgehensweise des
  361.         Amiga-Oberon-Systems entspricht.
  362.         
  363.       Nur Modul - berücksichtigt nur die Informationen aus einer OberonPrefs-
  364.         Kopfzeile am Anfang des Oberon-Quelltext-Moduls, einschließlich 
  365.         Buchstabenoptionen und Quelltextoptionen.
  366.         
  367.       Nur Prefs - berücksichtigt nur Informationen aus den Oberon.prefs /  
  368.         OLink.prefs - Voreinstellungsdateien.
  369.         
  370.     Weiterhin steht noch ein Schalter zur Verfügung, der festlegt, wie die
  371.     (Oberon|OLink).prefs- Voreinstellungsdateien eingelesen werden:
  372.     
  373.       Prefs: Global Lesen Möglich? - falls aktiv versucht OberonPrefs bei
  374.         nicht vorhandenen Voreinstellungsdateien im Projekt-Verzeichnis,
  375.         die globalen Voreinstellungsdateien im Verzeichnis OBERON: zu lesen.
  376.         Dies entspricht der programminternen ('Default') Einstellung von
  377.         OberonPrefs, da auch das Amiga-Oberon-System so vorgeht.
  378.         
  379.   Projekt-Einstellungen Schreiben-Untermenü:
  380.     Mit den Menüpunkten dieses Untermenüs kann der Benutzer festlegen, wie
  381.     OberonPrefs beim Schreiben von Projekt-Voreinstellungen vorgeht. Folgende
  382.     Schalter sind vorhanden:
  383.     *1*
  384.     
  385.       Stapelbare Optionen Als Quelltext? - falls aktiv schreibt OberonPrefs
  386.         auch diejenigen Optionen, die über Buchstaben-Optionen in der
  387.         Kommandozeile und die Voreinstellungsdateien eingestellt werden
  388.         können und auch als Quelltext-Optionen dem Amiga-Oberon-System
  389.         bekannt sind, als Quelltextoptionen in die OberonPrefs-Kopfzeile des
  390.         Oberon-Quelltext-Moduls. Dies entsprach bis OberonPrefs 1.9 der 
  391.         programminternen Voreinstellung von OberonPrefs. In den neueren
  392.         Versionen von OberonPrefs ist die programminterne Voreinstellung,
  393.         dies zu unterlassen.
  394.         *1*
  395.         
  396.       Buchstaben-Optionen Schreiben? - falls aktiv schreibt OberonPrefs
  397.         die Buchstaben-Optionen für den Compiler- / Linker-Aufruf in die
  398.         OberonPrefs-Kopf-Zeile des Oberon-Quelltext-Moduls. Früher war dies
  399.         programminterne Voreinstellung bis OberonPrefs 1.9; in den neueren
  400.         Programmversionen von OberonPrefs ist dieser Menüpunkt dagegen
  401.         aufgrund der programminternen Voreinstellung von OberonPrefs
  402.         deaktiviert.
  403.         *1*
  404.         
  405.     Weiterhin kann mit diesem Untermenü eine von vier Arten ausgewählt werden,    
  406.     wie OberonPrefs (Oberon|OLink).prefs-Voreinstellungsdateien beim Speichern
  407.     behandelt:
  408.       
  409.       Prefs Mit Optionen Schreiben - falls aktiv schreibt OberonPrefs
  410.         die Voreinstellungsdateien mit den gewählten Optionen ins Projekt-
  411.         Verzeichnis. (Programminterne Voreinstellung von OberonPrefs)
  412.         *1*
  413.         
  414.       Leere Optionen Schreiben - falls aktiv schreibt OberonPrefs leere  
  415.         Voreinstellungsdateien ins Projekt-Verzeichnis. Dies ist nützlich,
  416.         wenn das Amiga-Oberon-System ohne Berücksichtigung der
  417.         (Oberon|OLink).prefs- Voreinstellungsdateien arbeiten soll, da
  418.         so verhindert wird, daß irgendwelche Informationen aus den
  419.         Voreinstellungsdateien, auch nicht aus den globalen im OBERON:- 
  420.         Verzeichnis, verwendet werden.
  421.         *1*
  422.         
  423.       Keine Prefs Schreiben - falls aktiv ignoriert OberonPrefs vorhandene
  424.         (Oberon|OLink).prefs- Voreinstellungsdateien im Projekt-Verzeichnis
  425.         und schreibt auch keine Voreinstellungsdateien. Nützlich, falls
  426.         nur die Optionen eines Oberon-Quelltext-Moduls im Projekt-Verzeichnis
  427.         geändert wurden, und diese Änderungen nicht für die anderen
  428.         Oberon-Quelltext-Module im Projekt-Verzeichnis gelten sollen.
  429.         *1*
  430.         
  431.       Prefs Löschen - falls aktiv, löscht OberonPrefs vorhandene  
  432.         Voreinstellungsdateien im Projektverzeichnis, und schreibt keine
  433.         solchen zurück.
  434.         *1*
  435.         
  436.     Schließlich kann hier noch der Modus eingestellt werden, wie OberonPrefs   
  437.     Options-ToolTypes von Projekt-Piktogrammen handhaben soll:
  438.       
  439.       ToolTypes Schreiben - falls aktiv schreibt OberonPrefs die aktuellen
  440.         Optionen als ToolTypes in die Projekt-Piktogramme. Dies war
  441.         bis einschließlich OberonPrefs 1.9 grundsätzlich der Fall. Falls 
  442.         beim Programmstart ein 'alter' SETTINGS-Wert von OberonPrefs <= 
  443.         V1.9 als SETTINGS/N/K-Argument übergeben wird oder aus 
  444.         ENVARC:OberonPrefs.prefs gelesen wird, ist dies aus Kompatibilitäts-
  445.         gründen auch bei neueren OberonPrefs-Versionen die Voreinstellung.
  446.         *1*
  447.         
  448.       ToolTypes Ignorieren - falls aktiv ignoriert OberonPrefs eventuell 
  449.         bestehende Options-ToolTypes in Projekt-Piktogrammen und schreibt
  450.         auch keine eigenen ToolTypes. (Programminterne Voreinstellung von 
  451.         OberonPrefs ab OberonPrefs 1.10)
  452.         *1*
  453.         
  454.       ToolTypes Löschen - falls aktiv löscht OberonPrefs eventuell bereits
  455.         bestehende Options-ToolTypes in Projekt-Piktogrammen, schreibt jedoch
  456.         keine eigenen ToolTypes in die Projekt-Piktogramme zurück.
  457.         *1*
  458.         
  459.   Einstellungen Speichern  - dieser Menüpunkt speichert die im Einstellungen-
  460.     Menü von OberonPrefs gemachten Einstellungen ab, so daß sie bei jedem
  461.     zukünftigen Programmstart von OberonPrefs wieder gesetzt werden. (Das  
  462.     Kommandozeilen-/ ToolTypes-Argument SETTINGS/N/K überschreibt diese
  463.     Einstellungen)
  464.     *1*
  465.  
  466.  
  467.  
  468. *1* :  Ist nicht vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  469.        oder OMAKEOUT beim Programmstart übergeben wird.
  470.  
  471.  
  472.         
  473.   -----------------------------------------
  474.   Piktogramm-Ziehen ins OberonPrefs-Fenster
  475.   -----------------------------------------
  476.  
  477. Weiterhin können in das OberonPrefs-Fenster Piktogramme gezogen werden. 
  478.   Die Funtion entspricht dabei der des Datei-Gadgets.
  479.   *1*
  480.   
  481.  
  482. *1* :  Ist nicht vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  483.        oder OMAKEOUT beim Programmstart übergeben wird.
  484.  
  485.  
  486.  
  487.  
  488.                   Kommandozeilen- / ToolTypes-Argumente:
  489.                   --------------------------------------
  490.  
  491.  
  492. Die Argument-Schablone von OberonPrefs lautet:
  493.  
  494. FROM,TO=FILE,OBERONOPTS/K,OLINKOPTS/K,EDIT/S,USE=SAVE/S,OBERONOUT/S,
  495. OLINKOUT/S,OMAKEOUT/S,GLOBAL/S,LOCAL/S,PUBSCREEN/K,NOGUI/S,NOSAVEGAD/S,
  496. SETTINGS/N/K,
  497. NoStackChk=S/S,NoOvflChk=V/S,NoRangeChk=B/S,NoCaseChk=C/S,NoReturnChk=R/S,
  498. NoNilChk=N/S,OddChk=O/S,NoTypeChk=T/S,SmallCode=M/S,SmallData=D/S,
  499. NoImplementation/S,NoGarbageCollector=A/S,NoExtensions=E/S,Debug=G/S,
  500. NoClearVars=Z/S,Icons=I/S,NoNewSymbols=Y/S,Small/S,mc68881=8/S,
  501. NoAutoRegPars=P/S,CodeChip/S,DataChip/S,VarsChip/S,mc68030=3/S,
  502. mc68020=2/S,mc68010=1/S
  503.  
  504. Die Argumente im einzelnen:
  505.  
  506. FROM - Dateiname des Projektes, dessen Voreinstellungen eingelesen werden
  507.   sollen. Es existieren zwei spezielle Namen, sogenannte 'Magics':
  508.     Global - liest die globalen Voreinstellungen ein. (Voreinstellung, falls
  509.       dieses Argument ausgelassen wird)
  510.     Default - liest die programminternen Voreinstellungen des Amiga-Oberon-
  511.       Systems ein.
  512.   Die Verwendung der Schalter LOCAL/S u./o. USE=SAVE/S bewirkt, daß bei
  513.   nicht vorhandenem TO=FILE-Argument, und falls das FROM-Argument kein 
  514.   'Magic' ist, das FROM-Argument als TO=FILE-Argument übernommen wird.
  515.  
  516. TO=FILE - Dateiname des Projektes, das bearbeitet werden soll. Die Angabe
  517.   dieses Argumentes impliziert den Schalter LOCAL/S, und schließt die
  518.   Benutzung des Schalters GLOBAL/S aus.
  519.   
  520. OBERONOPTS/K,OLINKOPTS/K - siehe weiter unten.
  521.  
  522. EDIT/S - Schalter, der angibt, daß OberonPrefs im interaktiven Modus  
  523.   arbeiten soll. Da dies die programminterne ('Default') Einstellung
  524.   von OberonPrefs ist, kann er immer weggelassen werden. Die Verwendung
  525.   von EDIT/S schließt diejenige der Schalter USE=SAVE/S und NOGUI/S
  526.   aus.
  527.  
  528. USE=SAVE/S - Schalter, der angibt, daß OberonPrefs die gelesenen
  529.   Voreinstellungen speichern soll, ohne die interaktive Benutzer-
  530.   schnittstelle zu aktivieren. Schließt die Verwendung von EDIT/S aus,
  531.   und setzt voraus, daß bei aktivem Projekt-Modus ein existierender
  532.   Projektname als TO=FILE-Parameter angegeben ist (der auch vom FROM-
  533.   Parameter übernommen werden kann, s.o.)
  534.   
  535. OBERONOUT/S  
  536. OLINKOUT/S  
  537. OMAKEOUT/S  - Diese Schalter schließen sich gegenseitig aus, und bewirken,
  538.   daß OberonPrefs bei ordnungsgemässer Beendigung den Kommandozeilen-
  539.   Optionsstring mit den Buchstabenoptionen für Oberon / OLink / OMake
  540.   ausgibt. Diese Argumente sind äußerst wichtig für die Verwendung von
  541.   OberonPrefs in Stapelverarbeitungsdateien und ARexx-Skripten.
  542.   Die grafische Benutzerschnittstelle von OberonPrefs wird durch diese
  543.   Argumente außerdem verändert:
  544.     Es ist nicht mehr möglich, den Operations-Modus (Global / Projekt)
  545.     zu ändern, außerdem kann kein anderes Projekt als das angegebene 
  546.     verändert werden, und die Einstellmöglichkeiten im Einstellungen-
  547.     Menü sind auf die Menüpunkte des Untermenüs 'Projekt-Voreinstel-
  548.     lungen lesen' beschränkt. Anstelle des 'Abbrechen'-Gadgets 
  549.     erscheint ein 'Benutzen'-Gadget (Die Funktion des Abbrechen-Gadgets
  550.     kann natürlich weiterhin mit dem Schließ-Gadget und dem Menüpunkt
  551.     'Projekt->Beenden' erreicht werden), resp. bei angegebenem NOSAVEGAD/S-
  552.     Schalter wird das 'Speichern'-Gadget durch ein 'Benutzen'-Gadget
  553.     ersetzt. In diesem Fall kann die Funktion Speichern nicht mehr
  554.     erreicht werden.
  555.  
  556. GLOBAL/S - Dieser Schalter setzt den globalen Operationsmodus 
  557.   (Voreinstellung von OberonPrefs). Inkompatibel mit den Argumenten 
  558.   TO=FILE und LOCAL/S.
  559.   
  560. LOCAL/S - Dieser Schalter setzt den Projekt-Operationsmodus. Inkompatibel  
  561.   mit GLOBAL/S. Wird automatisch gesetzt bei angegebenem TO=FILE-Argument
  562.   oder bei angebenem Nicht-'Magic'-FROM-Argument und angegebenem
  563.   USE=SAVE/S-Schalter.
  564.   
  565. PUBSCREEN/K - Hier kann der Name des öffentlichen Schirms angegeben werden,  
  566.   auf dem das Fenster der grafischen Benutzerschnittstelle geöffnet werden
  567.   soll. Falls der angegebene Schirm nicht existiert, wird auf den System-
  568.   Default-Schirm ausgewichen (was die programminterne Voreinstellung von
  569.   OberonPrefs ist).
  570.   
  571. NOGUI/S - Dieser Schalter ist nur sinnvoll bei Verwendung einer der Schalter
  572.   OBERONOUT/S, OLINKOUT/S oder OMAKEOUT/S. Er bewirkt, daß bei nicht
  573.   gesetztem USE=SAVE/S-Schalter die grafische Benutzerschnittstelle trotzdem
  574.   nicht geöffnet wird, sondern nur die jeweiligen Voreinstellungen eingelesen
  575.   werden und entsprechend dem angegebenen #?OUT/S-Schalters der Optionsstring
  576.   ausgegeben wird. Weiterhin ist die Verwendung dieses Schalters immer dann
  577.   erlaubt (aber ohne Auswirkung), wenn zugleich der USE=SAVE/S-Schalter
  578.   angegeben wird.
  579.  
  580. NOSAVEGAD/S - Dieser Schalter ist nur bei angegebenm #?OUT/S-Schalter und bei
  581.   Verwendung der grafischen Benutzerschnittstelle erlaubt. Seine Auswirkungen
  582.   sind in der Dokumentation der #?OUT/S-Schalter beschrieben.
  583.   
  584. SETTINGS/N/K - Hier wird die Angabe einer gültigen Dezimalzahl erwartet, die
  585.   dekodiert gültige Einstellungen im Einstellungen-Menü von OberonPrefs
  586.   liefert. 
  587.     Die gewünschte Zahl kann leicht ermittelt werden, indem man
  588.     innerhalb der grafischen Benutzerschnittstelle die Einstellungen auf den
  589.     gewünschten Wert ändert und dann das Informationsfenster mit dem Menü-
  590.     punkt Projekt->Information... öffnet. In der letzten Zeile dieses
  591.     Fensters ist dann der Code für die gegenwärtigen Einstellungen zu
  592.     finden.
  593.     *1*
  594.  
  595.  
  596. Die restlichen Argumente dienen dazu, einzelne Compiler-/ Linker-Optionen zu 
  597. setzen/löschen:
  598.  
  599. OBERONOPTS/K: - erwartet die Angabe eines gültigen Optionsstrings für
  600.   den Oberon-Compiler, bestehend aus einem optionalen '-', gefolgt von den
  601.   einzelnen Buchstaben-Optionen.
  602.     
  603. OLINKOPTS/K: - erwartet die Angabe eines gültigen Optionsstrings für OLink,
  604.   bestehend aus einem optionalen '-', gefolgt von den einzelnen Buchstaben-
  605.   Optionen.
  606.  
  607. NoStackChk=S/S,NoOvflChk=V/S,NoRangeChk=B/S,NoCaseChk=C/S,NoReturnChk=R/S,
  608. NoNilChk=N/S,OddChk=O/S,NoTypeChk=T/S,SmallCode=M/S,SmallData=D/S,
  609. NoImplementation/S,NoGarbageCollector=A/S,NoExtensions=E/S,Debug=G/S,
  610. NoClearVars=Z/S,Icons=I/S,NoNewSymbols=Y/S,Small/S,mc68881=8/S,
  611. NoAutoRegPars=P/S,CodeChip/S,DataChip/S,VarsChip/S,mc68030=3/S,
  612. mc68020=2/S,mc68010=1/S - setzt / löscht jeweils eine einzelne Option.
  613.  
  614.  
  615.  
  616. *1* :  Ist nicht vorhanden, falls eines der Argumente OBERONOUT, OLINKOUT
  617.        oder OMAKEOUT beim Programmstart übergeben wird.
  618.  
  619.  
  620.  
  621.   Benutzerdefinierbare interaktive Argument-Abfrage beim Programmstart:
  622.   ---------------------------------------------------------------------
  623.  
  624. OberonPrefs bietet Ihnen beim Workbench-Start in Verbindung mit ToolTypes-
  625. Argumenten die Möglichkeit, sich einzelne, mehrere oder alle Argumente 
  626. durch interaktive Argument-Eingabefenster ('Argument-Requester') zu
  627. beschaffen, falls Sie in Ihrem System die reqtools.library Version 38 oder
  628. höher istalliert haben. Dazu müssen Sie für die Argumente, für die solche
  629. Eingabe-Fenster erscheinen sollen, gültige ToolType-Einträge anlegen, deren
  630. Namen Sie ein 'ASK:' vorstellen müssen. Also etwa 'Ask:Settings=971', o.ä.
  631.  
  632.  
  633.                        Programmende & Rückgabewerte
  634.                        ----------------------------
  635.  
  636. Falls OberonPrefs mittels des Speichern-Gadgets, des Benutzen-Gadgets oder
  637. durch die entsprechenden Tastaturäquivalente verlassen wird, terminiert
  638. OberonPrefs mit einem Rückgabewert 0 (OK).  Wenn die grafische
  639. Benuzterschnittstelle aufgrund der übergebenen Argumente nicht geöffnet
  640. wird, und OberonPrefs ordnungsgemäß terminiert, wird ebenfalls 0
  641. zurückgegeben.  Im anderen Fall, falls OberonPrefs durch den
  642. Projekt->Beenden-Menüpunkt, durch das Schließgadget, durch Drücken der
  643. ESC-Taste, durch das Cancel-Gadget oder das zugehörige Tastaturäquivalent
  644. beendet wird, liefert es den Rückgabewert 5 (WARN).  In allen anderen
  645. Fällen - wenn also OberonPrefs aufgrund fehlerhafter Argumente oder
  646. aufgrund von für OberonPrefs ungenügenden System-Ressourcen terminiert,
  647. liefert es den Rückgabewert 20 (FAIL), gibt, wenn nicht einer der Schalter
  648. OBERONOUT/S, OLINKOUT/S oder OMAKEOUT/S spezifiziert wurde, eine
  649. entsprechende Meldung auf dem aktuellen Ausgabekanal aus und läßt zusätlich
  650. den Bildschirm aufflackern, falls es von der Workbench aus gestartet wurde.
  651.  
  652.  
  653.  
  654.                    Allgemeine Hinweise zum Programm
  655.                    --------------------------------
  656.  
  657. Als gültige Projekte werden nur solche Projekte erkannt, deren Namen
  658. auf '.mod' endet und die keine Binärdaten enthalten.  OberonPrefs hat
  659. aber wie der Amiga-Oberon-Compiler die Fähigkeit, das '.mod'-Suffix
  660. automatisch an einen spezifizierten Dateinamen anzuhängen und
  661. außerdem, falls das Oberon-Quelltext-Modul im angegebenen Verzeichnis
  662. nicht gefunden werden konnte, im Unterverzeichnis 'txt' nach ihm zu
  663. suchen.
  664.  
  665.  
  666. Durch das Konvertieren von Projekt-Voreinstellungen nach globalen
  667. Voreinstellungen, oder dem Nur-Einlesen der #?.prefs-Voreinstellungs-
  668. dateien bei Projekten gehen mögliche CodeChip+, DataChip+, VarsChip+
  669. und Implementation- - Einstellungen verloren, da diese nur in
  670. Oberon-Quelltext-Moduen gespeichert werden können.
  671.  
  672.  
  673. Eine Bemerkung zum verwendeten ToolTypes-Parsing:  Es wird das mächtige
  674. ToolTypes-Parsing aus BlackMagic verwendet, das AmigaDOS-ReadArgs()-
  675. Schablonen erschöpfend unterstützt und das geniale 'Argument-Request'
  676. bietet.
  677.  
  678.  
  679.  
  680.  
  681.                  ----------------------------------------
  682.                  Vermeiden des Veränderns des Quelltextes 
  683.                  d.h. Anlegen/Ändern der OPREFS-Kopfzeile
  684.                  ----------------------------------------
  685.  
  686. Falls Sie das Schreiben von OPREFS-Kopfzeilen auf Dauer vermeiden wollen,
  687. sollten Sie die Menüpunkte
  688.  
  689. * Einstellungen->Vorgaben-Optionen·Speichern?
  690.  
  691. sowie
  692.  
  693. * Einstellungen->Projekt-Einstellungen·Schreiben->Stapelbare·Optionen·
  694.                                                   Als·Quelltext?
  695.  
  696. und                                            
  697.  
  698. * Einstellungen->Projekt-Einstellungen·Schreiben->Buchstaben-Optionen·
  699.                                                   Schreiben?
  700.  
  701. deaktivieren und diese Einstellungen mit Hilfe des Menüpunktes
  702.  
  703. * Einstellungen->Einstellungen·Speichern
  704.  
  705. für Ihr System als Voreinstellungen abspeichern.
  706.  
  707.  
  708.         * Ab OberonPrefs  1.10  entspricht dies  den  programm-  *
  709.         * internen Voreinstellungen ('Defaults') von OberonPrefs *
  710.  
  711.  
  712.  
  713.  
  714.                           Entwicklungsgeschichte
  715.                           ----------------------
  716.  
  717.   v1.0 [fSchwarz] 28.6.93  First fully functional version
  718.  
  719.   v1.1 [fSchwarz] 4.7.93  Removed stupid bug in argument
  720.     processing order: processed SETTINGS after FROM & TO
  721.  
  722.   v1.2 [fSchwarz] 6.7.93  Added display clip sensitivity
  723.     when rendering x/y positions, pr.windowPtr redirection
  724.  
  725.   v1.3 [fSchwarz] 6.7.93  Added warning requester for
  726.     filenames not ending in '.mod', changed requester code
  727.  
  728.   v1.4 [fSchwarz] 9.7.93  Added 'OberonPrefs failed' msg &
  729.     Int.DisplayBeep() in case of failure, Dos.IoErr support
  730.  
  731.   v1.5 [fSchwarz] 16.7.93  Fixed Asl.save-Flag FReq bug
  732.  
  733.   v1.6 [fSchwarz] 17.7.93  Removed ~'.mod' warn requester,
  734.     adapted filename handling to Oberon's (add missing
  735.     '.mod' suffix, search in 'txt' subdirectory)
  736.  
  737.   v1.7 [fSchwarz] 21.7.93  Adapted to new BlackMagic layout
  738.  
  739.   v1.8 [fSchwarz] 14.8.93  Recompiled with BlackMagic 1.10:
  740.     now argument requesters may pop up if wbstarted
  741.  
  742.   v1.9 [fSchwarz] 9.9.93  fixed mc680x0 option management
  743.     due to very strange compiler feature: Enabling 68030
  744.     instruction generation does NOT imply generation of
  745.     68020/68010 instructions, etc.
  746.  
  747.   v1.10 [fSchwarz] 10.9.93  Added user control of Project-
  748.     ToolTypes writing via Settings menu; changed default
  749.     settings so that usually no source writes are needed.
  750.  
  751.   v1.11 [fSchwarz] 13.9.93  Minor cosmetic code changes,
  752.     now works well with a NIL Asl.base, added
  753.     complete English docs, corrected German docs, updated
  754.     strings.
  755.  
  756.   v1.11a [fSchwarz] 17.9.93 Added Busypointer & window
  757.     blocking during writing / reading operations (suggested
  758.     by Christian Stiens)
  759.  
  760.   v1.11b [fSchwarz] 18.9.93 now also locked GUI during
  761.     ValidateFName() due to packing filesys like XFH, etc.
  762.  
  763.   v1.11c [fSchwarz] 18.9.93 DisplayBeeps if ValidateFName()
  764.     fails in interactive mode.
  765.  
  766.   v1.11d [fSchwarz] 20.9.93 Now writes OLink.prefs options
  767.     in complete upper case.
  768.  
  769.   v1.11e [fSchwarz] 30.9.93 Now uses smartRefresh window,
  770.     adapted to Hartmut Goebel's OS3.0-interface modules,
  771.     removed FReq-Hook (due to frequently used braindead
  772.     broken ASL-patches)
  773.  
  774.   v2.0 [fSchwarz] 8.10.93 Enhanced window locking with
  775.     new BlackMagic1.12. Improved AppWindow icon dropping
  776.     feature: Project-FileRequester pops up if the dropped
  777.     icon is no valid Oberon source code module. Since no
  778.     bugs showed up despite deep, thoroughgoing testing,
  779.     debug code defaults to off, all runtime code checks
  780.     are disabled, so maximum performance is guaranteed and
  781.     minimum code size is ensured. Thus, as this version is
  782.     considered to be 'final', major revision count has been
  783.     incremented to 2.
  784.  
  785.  
  786.  
  787.  
  788.                              Schlußbemerkungen
  789.                              -----------------
  790.  
  791. OberonPrefs wird mit Quelltext veröffentlicht.  Er verdeutlicht die
  792. Vielseitigkeit des BlackMagic-Moduls und seine Nützlichkeit beim Kreiren
  793. von Amiga User Interface Style Guide-konformen Applikationen.
  794.  
  795.  
  796. Bugs (Programmfehler):  Zum Zeitpunkt des Verfassens dieser Dokumentation
  797. sind dem Autor keinerlei Fehlfunktionen dieses Programms bekannt.  Bei dem
  798. Umfang dieses Programms ist jedoch der eine oder andere Bug grundsätzlich
  799. nicht auszuschließen!
  800.  
  801. OberonPrefs ist Giftware.  Das heißt, ich ermuntere Sie, mir, falls Sie
  802. sich für das Programm begeistern können, als Anerkennung ein kleines
  803. Geschenk, eine Spende, eine nette Postkarte, o.ä.  zukommen zu lassen.
  804. Auch jedwede Kritik, Änderungsvorschläge, natürlich Bugreports
  805. (Fehlerberichte), etc. sind herzlich willkommen.
  806.  
  807. Falls Sie die deutsche Dokumentation in andere Sprachen übersetzen, oder
  808. Katalog-Dateien für andere Sprachen als Deutsch erstellen, so können Sie
  809. diese gerne diesem Archiv hinzufügen und mir zusenden. Vielen Dank!
  810.  
  811. OberonPrefs ist urheberrechtlich geschützt. Copyright © 1993 Franz Schwarz.
  812.  
  813. Der Autor haftet für keinerlei Schäden, die unmittelbar oder mittelbar, vom
  814. Gebrauch dieses Programms herrühren.
  815.  
  816. OberonPrefs ist frei kopierbar; es darf auf der Amok-Serie und auf anderen
  817. nicht-kommerziellen Disketten-Serien vertrieben werden, inklusive
  818. CD-ROM-Versionen derselben, ebenfalls darf es auf dem Weg der
  819. elektronischen Datenübertragung verbreitet werden.
  820.  
  821. OberonPrefs darf nur in diesem Archiv komplett verbreitet werden.
  822. Weiterhin darf es nur verbreitet werden, falls der Vertreiber kein
  823. Urheberrecht auf das Archiv noch auf Dateien, die zwangsweise mit ihm
  824. übertragen werden, erhebt.  Anfragen auf Ausnahmen von diesen
  825. Beschränkungen können an den Autor gerichtet werden.
  826.  
  827.  
  828.  
  829.                     Sie erreichen mich folgendermaßen:
  830.                     ----------------------------------
  831.  
  832.                                Franz Schwarz
  833.                    Mühlenstraße 2, D-78591 Durchhausen,
  834.                               BR Deutschland
  835.                     Uucp: Franz_Schwarz@mil.ka.sub.org
  836.                     Fido: 2:2476/506.18 & 2:241/7506.18
  837.               Kto. 951.207 bei BLZ 643 500 70 KSK Trossingen
  838.  
  839.  
  840.  
  841.  
  842.  
  843.                            Credits, Danksagungen
  844.                            ---------------------
  845.  
  846. Die grafische Benutzerschnittstelle wurde erstellt mit Hilfe von
  847. GadToolsBox 37.176 by Jan van der Baard und Kai Bolay (Oberon source
  848. generator).  Ohne GadToolsBox hätte es wohl OberonPrefs nie gegeben.
  849. Einen galaktischen Donnergurgler-Toast auf die beiden;-)
  850. Die CygnusEd-Skripte benutzen Kai Bolay's oberonsupport.library, und
  851. Teile der Skripte stammen ebenfalls aus seiner Feder.
  852. Die reqtools.library, von der OberonPrefs Nutzen ziehen kann, wurde
  853. geschrieben von und ist urheberrechtlich geschützt durch Nico François,
  854. jedoch frei vertreibbar, falls genau dies in der programmbegleitenden
  855. Dokumentation erwähnt wird.
  856.  
  857.  
  858.  
  859. Viel Spaß!
  860.  
  861.   Franz 'Blacky' Schwarz.
  862.  
  863.  
  864.  
  865.                       Die CygnusEd - ARexx - Skripte
  866.                       ------------------------------
  867.  
  868.  
  869. Die CygnusEd-ARexx-Skripte ermöglichen eine komfortable Steuerung des
  870. Amiga-Oberon-Systems von CygnusEd Professional aus. Die folgende
  871. Kurzanleitung geht davon aus, dass die beiliegende Funktionstasten-
  872. belegung in CyngusEd aktiviert ist.
  873.  
  874. F1 - Compile:  Ruft den Compiler auf. Falls das Modul verändert wurde
  875.   und noch nicht gespeichert ist, wird es vor dem Complieren gespeichert.
  876.   Zeigt den ersten Fehler an, falls Fehler beim Compilieren auftraten.
  877.   
  878. F2 - Link: Ruft den Linker auf.  
  879.  
  880. F3 - Make: Ruft OMake auf. Falls das Modul verändert wurde und noch nicht
  881.   gespeichert ist, wird es vor dem Aufruf von OMake gespeichert.
  882.  
  883. Compile, Link, als auch Make verwenden dabei folgende Compiler-/ Linker-
  884.   Optionen: falls von einem Aufruf von 'F7 - Change Temporary Options' her 
  885.   gültige temporäre Einstellungen existieren, werden diese verwendet.
  886.   Ansonsten werden die Optionen von OberonPrefs mit aktiviertem 
  887.   'Einstellungen->Projekt-Einstellungen Lesen->Modul & Prefs' und
  888.   'Einstellungen->Projekt-Einstellungen Lesen->Prefs: Global Lesen Möglich?'
  889.   eingelesen.
  890.  
  891. F4 - First Error: Springt zum ersten Fehler
  892.  
  893. F5 - Next Error : Springt zum nächsten Fehler vom Cursor aus gesehen.
  894.  
  895. F6 - Prev. Error: Springt zum vorhergehenden Fehler vom Cursor aus gesehen.
  896.  
  897. F7 - Change Temporary Options: Setze / lösche temporäre Optionen für ein
  898.   Modul. Falls das Modul verändert wurde und noch nicht gespeichert ist,
  899.   wird es vor dem Aufruf von OberonPrefs gespeichert.
  900.  
  901. F8 - Change Options: Unbeschränktes Manipulieren von Optionen beliebiger
  902.   Projekte und der globalen Optionen mit OberonPrefs. Falls der gegenwärtig
  903.   edierte Text ein Oberon-Quelltext-Modul ist, das verändert wurde und noch
  904.   nicht gespeichert ist, wird es vor dem Aufruf von OberonPrefs gespeichert.
  905.   Wenn sie die Optionen des gegenwärtig edierten Moduls geändert und
  906.   gespeichert haben, sollten Sie das Modul mit dem CygnusEd-Menüpunkt
  907.   Project->Open... nach Beendigung von OberonPrefs neu einlesen.
  908.  
  909.  
  910. Falls Sie die ARexx-Skripte regelmäßig verwenden, ist dringend zu
  911. empfehlen, OberonPrefs mit 'Resident OBERON:OberonPrefs' resident in den
  912. Speicher zu laden.
  913.  
  914.  
  915. Für weitere Infos über die Rexx-Steuerung genügt ein Blick auf die 
  916.   ARexx-Skripte.
  917.  
  918.  
  919.       Bye,
  920.         Franz 'Blacky' Schwarz
  921.  
  922.                - Girlfriend Is Better - Talking Heads -
  923.  
  924.